home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / utmisc1 / unitconv.lha / unitconv / anleitung / UnitConv.dok next >
Text File  |  1996-04-27  |  16KB  |  406 lines
  1. UnitConv - Technisch-wissenschaftlicher Einheitenkonverter
  2.  
  3. Version 1.10d
  4. FREEWARE
  5. ©1994-96 SciTech Software Development
  6.  
  7. INHALT
  8.  
  9. 1.  Einleitung
  10. 2.  Systemvoraussetzungen
  11. 3.  Garantie, Copyright, Weitergabe
  12. 4.  Installation
  13. 5.  Aufruf von UnitConv
  14. 6.  Bedienung
  15. 7.  Die Datei "techkonv.dat"
  16. 8.  Bekannte Fehler
  17. 9.  Entwicklungsgeschichte, Zukünftige Entwicklungen
  18. 10. Credits, sonstige SciTech-Programme
  19. 11. Kontaktadresse
  20.  
  21.  
  22.  
  23. 1. Einleitung
  24.  
  25. Jeder, der häufig oder auch nur gelegentlich vor dem Problem steht, einen Zahlenwert,
  26. der bezüglich einer bestimmten Einheit (z.B. Meter) gegeben ist, in einen äquivalenten
  27. Wert bezüglich einer anderen Einheit (z.B. Meilen) umzuwandeln, kennt den Aufwand,
  28. der damit verbunden ist. Zwar ist das eigentliche Umrechnen üblicherweise kein Problem,
  29. aber wer kennt den Umrechnungsfaktor von z.B. Meter auf Meilen schon auswendig.
  30. Der Hauptaufwand bei solchen Problemen liegt also zumeist darin, den entsprechenden
  31. Umrechnungsfaktor aus der Fachliteratur herauszusuchen, was insbesondere bei
  32. exotischen Einheiten sehr langwierig sein kann.
  33.  
  34. Dieser Mißstand kann nun durch Einheitenkonverter wie UnitConv behoben werden.
  35. UnitConv kennt insgesamt 243 verschiedene Einheiten, die in 16 Gruppen eingeteilt sind:
  36.  
  37. - Länge
  38. - Fläche
  39. - Volumen
  40. - Winkel
  41. - Masse
  42. - Zeit
  43. - Geschwindigkeit
  44. - Temperatur
  45. - Kraft
  46. - Energie
  47. - Leistung
  48. - Druck
  49. - Elektrizität
  50. - Radioaktivität
  51. - Licht
  52. - Diverse
  53.  
  54. Zusätzlich steht noch eine "User-Gruppe" zur Verfügung. Hier kann der Anwender eigene
  55. Einheiten definieren, indem er eine Textdatei namens "techkonv.dat" anlegt, in der 
  56. dann wie hier beschrieben die entsprechenden Werte eingtragen werden. Eine
  57. Beispieldatei ist im Archiv enthalten.
  58.  
  59.  
  60.  
  61. 2. Systemvoraussetzungen
  62.  
  63. - 1 Amiga (no na)
  64. - Kickstart/Workbench 2.04 oder höher
  65. - Helvetica 11 - Font im FONTS:-Verzeichnis
  66. - mindestens 200 kB freien Speicher
  67.  
  68. Sind diese Voraussetzungen gegeben, so sollten an sich keine Probleme auftreten.
  69. Getestet wurde UnitConv mit folgenden Konfigurationen:
  70.  
  71. A2000C mit A2630, 1MB CHIP, 4MB 16-Bit FAST, 2MB 32-Bit FAST, Oktagon SCSI2-Kontroller,
  72. Picasso Grafikkarte, Amiga OS3.1
  73.  
  74. A2000C mit Blizzard 2060/50, 1MB CHIP, 8 MB 32-Bit FAST, Blizzard FastSCSI2,
  75. Picasso Grafikkarte, Amiga OS3.1
  76.  
  77. Garantie wird (logischerweise) keine übernommen (weder für Funktion noch für Folgeschäden!!)
  78.  
  79.  
  80.  
  81. 3. Garantie, Copyright, Weitergabe
  82.  
  83. 3.1 Garantie
  84.  
  85. Es wird keinerlei Garantie gegeben, weder bezüglich korrekter Programmfunktion noch
  86. für Folgeschäden.
  87.  
  88. 3.2 Copyright, Weitergabe
  89.  
  90. Es gelten die allgemein üblichen Bedingungen für FREEWARE-Programme.
  91. Alle Rechte liegen beim Autor.
  92.  
  93. Dieses Programm darf beliebig weitergegeben und verteilt werden, es darf allerdings 
  94. keinerlei Gebühr in irgendeiner Art und Weise dafür verlangt werden, mit Ausnahme einer
  95. angemessenen Kopiergebühr, die aber den Preis einer DD-Diskette nicht übersteigen darf 
  96. (max. öS20,-- oder DM 3,--).
  97. Außerdem darf das Programm nur komplett (d.h. inklusive dieser Datei) weitergegeben 
  98. werden.
  99.  
  100. Das Programm darf beliebig (also auch kommerziell) verwendet werden.
  101.  
  102.  
  103.  
  104. 4. Installation
  105.  
  106. Die Installation ist so einfach, daß ich es für nicht notwendig erachtet habe, ein
  107. Installerscript dafür zu schreiben:
  108.  
  109. Kopieren Sie einfach den UnitConv-Ordner in das gewünschte Zielverzeichnis (mittels
  110. Workbench durch Ziehen der Schublade, mittels CLI/Shell mit dem Befehl COPY oder mit
  111. einem DOS-Tool wie DirectoryOpus).
  112. Es sind keinerlei Anpassungen (ASSIGN`s o.ä. notwendig).
  113. Sie müssen vor dem Programmstart allerdings sicherstellen, daß die Systemvoraussetzungen
  114. erfüllt sind. Falls sie nicht über die MagicWorkbench verfügen und aus diesem
  115. Grund die Icons etwas seltsam aussehen, so können Sie sie durch 4-Farb-Icons ersetzen,
  116. die sich im STD-Icons-Verzeichnis befinden.
  117.  
  118. ACHTUNG: techkonv.dat (Definition der User-Einheiten) muß sich im selben Verzeichnis
  119. wie UnitConv befinden.
  120.  
  121. 4.1 Zusätzliche Installationshinweise
  122.  
  123. Falls Sie UnitConv von Programmen wie "ToolManager" oder "Directory Opus" aus verwenden
  124. wollen, beachten Sie bitte die Anleitungen zu den jeweiligen Programmen.
  125.  
  126. Mehrere Dock-Brushes z.B. für Toolmanager sind im Programmumfang enthalten
  127. (Verzeichnis "Docks").
  128.  
  129. Toolmanager-Einstellungen: 
  130.  
  131. ExecType:  WB
  132. Stack:     4096
  133. Priority:  0
  134. Delay:     0
  135. Arguments: Deaktiviert
  136.  
  137. Achten Sie auf die korrekten Pfadangaben!! 
  138.  
  139.  
  140. DirectoryOpus-Einstellungen:
  141.  
  142. Type:         WB
  143. Befehlszeile: [PFAD] UnitConv 
  144. Flags:        Run asynchronously
  145.               Workbench to front     (UnitConv-Fenster wird immer auf WB-Screen geöffnet)
  146.  
  147. Diese Angaben gelten für DOpus V4.12, für andere Versionen sollte es ähnlich bzw.
  148. genauso funktionieren.
  149.  
  150.  
  151.  
  152. 5. Aufruf von UnitConv
  153.  
  154. Der standardmäßige Aufruf von UnitConv erfolgt entweder über die Workbench oder
  155. das CLI:
  156.  
  157. - Workbench: durch Doppelklick auf das UnitConv-Icon
  158. - CLI/Shell: unitconv <RETURN>
  159.  
  160. Es können keine Dateien als Argumente übergeben werden.
  161.  
  162.  
  163. Es ist auch möglich, UnitConv von DirectoryOpus oder ToolManager aus aufzurufen.
  164. Es können aber auch hierbei keine Dateien als Argumente übergeben werden, da 
  165. UnitConv über keine CLI- oder WB-Schnittstelle verfügt.
  166.  
  167.  
  168.  
  169. 6. Bedienung
  170.  
  171. Nach dem Start von UnitConv wird das Arbeitsfenster geöffnet. 
  172. In diesem sind 5 Auswahllisten (2 davon leer), 2 Stringgadgets und 2 Buttons sichtbar.
  173.  
  174. Die Auswahllisten steuern die Konvertierung, hier können Sie auswählen,
  175. von welcher Einheit die gewünschte Zahl in eine andere Einheit konvertiert werden soll.
  176. Die Bedienung läßt sich am leichtesten anhand eines Beispiels nachvollziehen:
  177.  
  178. 123.45 Milli-Curie sollen in Mega-Bequerel angegeben werden.
  179.  
  180. - Dazu wählen sie als erstes die gewünschte Einheitengruppe aus der 1. Liste aus, in
  181.   diesem Fall "Radioaktivität". 
  182.   Sobald sie eine Gruppe angewählt haben, erscheinen in der Liste "Eingabeeinheit" die in
  183.   dieser Gruppe enthaltenen Einheiten (in diesem Fall Bequerel, Curie, Gray, Röntgen).
  184. - Wählen sie nun Ihre Eingabeeinheit , hier "Curie", aus.
  185.   Sobald eine Eingabeeinheit ausgewählt wurde, erscheinen in der Liste "Ergebniseinheit"
  186.   diejenigen Einheiten, in die die Eingabeeinheit konvertiert werden kann.
  187.   Sie können also keine Einheiten konvertieren, die sich nicht aus dasselbe beziehen;
  188.   d.h. sie können z.B. Ampere nicht in Volt oder Curie nicht in Röntgen konvertieren.
  189.   (genausowenig wie man km/h nicht in Kilogramm umwandeln kann:-)
  190. - Nun kann die Ergebniseinheit aus der Liste "Ergebniseinheit" ausgewählt werden,
  191.   hier also Bequerel.
  192. - Jetzt müssen noch die Eingabe- und Ergebnispotenzen festgelegt werden. Dies geschieht
  193.   mit den Listen "Eingabepotenz" und "Ergebnispotenz". Wird hier nichts angegeben, so wird
  194.   voreinstellungsmäßig die Potenz Exa (10^18) verwendet.
  195.   Für unser Beispiel muß nun die Eingabepotenz Milli und die Ergebnispotenz Mega
  196.   angewählt werden.
  197. - Anschließend muß nur noch der gewünschte Zahlenwert (in unserem Fall 123.45) in das
  198.   Textfeld "Eingabe" eingetragen und mit <Return> bestätigt werden.
  199. - Wird nun auf den Button "Konvertieren" gedückt, so erscheint im Textfeld "Ergebnis"
  200.   nun die konvertierte Zahl 4567.650000 [M Bq]. Die in den eckigen Klammern stehende
  201.   Zeichenfolge ist die normgerechte Angebe der Ergebniseinheit, das M staht für Mega und
  202.   Bq für Bequerel.
  203. - Will man nun statt Mega-Bequerel Giga-Bequerel, so muß nur Giga in der Ergbnispotenz-List
  204.   angewählt werden und wieder "Konvertieren" gedrückt werden. Das neue Ergebnis steht 
  205.   wieder im "Ergebnis"-Feld, alle anderen Einstellungen wurden unverändert gelassen.
  206.  
  207. Die Bedienung von UnitConv sollte anhand dieses Beispiels leicht nachvollzogen werden können.
  208. Folgende Konventionen müssen aber beachtet werden:
  209. - Der erlaubte Zahlenbereich reicht von 1.7E-308 bis 1.7E+308 (das reicht zumindest aus,
  210.   um Atto-Angström im Exa-Parsec umrechnen zu können)
  211. - Große Zahlen können als Zehnerpotenz eingegeben werden, d.h. 1e3 anstelle von 1000
  212. - Kleine Zahlen können ebenso als Zehnerpotenz eingegeben werden, d.h. 1e-3 anstelle
  213.   von 0.001
  214. - Falls die Zahl im Eingabefeld geändert oder neu eingegeben wird, muß mit <Return>
  215.   bestätigt werden, da sonst die Zahl nicht übergeben wird.
  216. - Die Gruppe "User" enthält die in der Datei techkonv.dat festgelgten Einheiten. 
  217. - Falls ein Eingabefehler vorliegt (z.B. keine Eingabeeinheit gewählt), so wird im
  218.   Ergbnisgadget "Fehler" angezeigt.
  219. - Beachten Sie bitte, daß bei nichtlinearen Einheiten (zB Volumenseinheiten wie
  220.   Kubikmeter) die Eingabe- bzw. Ergebnispotenzen auch nichtlinear sind.
  221.   Das heißt, die Einstellung "Kilo" und "Kubikmeter" ergibt Kubikkilometer 
  222.   (=1000mx1000mx1000m = 1x10^9m³) und nicht Kilokubikmeter (=1000x1mx1mx1m = 1000m³)!
  223.   Das gleich gilt insbesondere auch für Flächeneinheiten!
  224. - Auf manche Einheiten können Potenzangaben nicht angewendet werden.
  225.   Es handelt sich hierbei um Einheiten, die nicht nur durch einen Faktor zur
  226.   Basiseinheit unterschiedlich sind, sondern darüber hinaus auch einen Summanden
  227.   bezüglich der Basis beinhalten. In solchen Fällen wird die entsprechende 
  228.   Potenzeinstellung ignoriert. Ein Beispiel für eine solche Einheit ist °Farenheit.
  229.   
  230.  
  231. 6.1 Beschreibung der einzelnen Gadgets
  232.  
  233. - Liste "Gruppen":         Liste, in dem die gewünschte Einheitengruppe ausgewählt wird
  234. - Liste "Eingabeeinheit":  Solange leer, bis eine Einheitengruppe gewählt wird. Hier kann die
  235.                            entsprechende Eingabeeinheit gewählt werden.
  236. - Liste "Eingabepotenz":   Festlegung der Eingabepotenz, voreingestellt:Exa
  237. - Liste "Ergebniseinheit": Solange leer, bis eine Eingabeeinheit gewählt wird. Hier kann die
  238.                            entsprechende Ergebniseinheit gewählt werden.
  239. - Liste "Ergebnispotenz":  Festlegung der Ergebnispotenz, voreingestellt:Exa
  240. - Stringgadget "Eingabe":  Hier wird die zu konvertierende Zahl eingegeben.
  241.                            Achtung: Eingabe mit <Return> abschließen!!
  242. - Stringgadget "Ergebnis": Hier wird das Ergebnis der Berechnung angezeigt.
  243. - Button "Konvertieren":   Startet die Konvertierung
  244. - Button "Beenden":        Beendet UnitConv
  245.  
  246.  
  247. 6.2 Beschreibung der Menüeinträge
  248.  
  249. - Projekt/Konvertieren:  siehe Gadget "Konvertieren"
  250. - Projekt/Über UnitConv: öffnet ein Fenster, in dem allgemeine Informationen über 
  251.                          das Programm angezeigt werden. Ein Klick auf OK schließt das
  252.                          Fenster wieder. 
  253. - Projekt/Beenden:       siehe Gadget "Beenden"
  254.  
  255.  
  256.  
  257. 7. Die Datei "techkonv.dat"
  258.  
  259. Um UnitConv um eigene Einheiten (z.B. Währungen) zu erweitern, können diese
  260. in der Datei "techkonv.dat" angegeben werden. Die Datei ist eine ASCII-Text-Datei,
  261. sie kann also mit jedem beliebigen Texteditor (z.B. Ed) bearbeitet werden.
  262. Es muß allerdings eine bestimmte Eingabesyntax eingehalten werden.
  263.  
  264. Die Eingabesyntax ist sehr leicht an einem Beispiel zu erkennen:
  265.  
  266.        { Beispiel einer externen Einheitendatei für TechConv V1.00 }
  267.        { # Name | Index | Fakt | Summ | PotFakt | Kurzname # }
  268.  
  269.        # Ext.Einheit 1 | 1 | 1.00 | 0.00 | 1 | eh1 #
  270.        # Ext.Einheit 2 | 1 | 2.00 | 0.00 | 1 | eh2 #
  271.        # Ext.Einheit 3 | 2 | 0.54 | 2.55 | 1 | eh3 #
  272.        # Ext.Einheit 4 | 1 | 1.55 | 0.00 | 1 | eh4 #
  273.        # Ext.Einheit 5 | 2 | 1.00 | 0.00 | 1 | eh5 #
  274.        # Ext.Einheit 6 | 2 | 3.40e-15 | 0.00 | 1 | eh6 #
  275.        # Ext.Einheit 7 | 1 | 70.56 | 0.00 | 1 | eh7 #
  276.        # Ext.Einheit 8 | 1 | 4.44e-9 | 0.00 | 1 | eh8 #
  277.        # Ext.Einheit 9 | 2 | 6.00 | 0.00 | 1 | eh9 #
  278.        # Ext.Einheit 10| 1 | 0.55 | 0.00 | 1 | eh10 #
  279.  
  280.  
  281. Alles was in geschwungener Klammer {} steht, ist ein Kommentar und wird ignoriert.
  282. Dies Kommentare dürfen nur am Anfang der Datei stehen, nicht
  283. geschachtelt sein und nur über eine Zeile gehen. Es sind aber beliebig 
  284. viele Kommentarzeilen erlaubt.
  285.  
  286. Die Einheiten selbst werden durch die Zeichen # ... # eingeschlossen.
  287. Auch sie dürfen nur über eine Zeile gehen. Es sind maximal 57 eigene Einheiten
  288. erlaubt.
  289.  
  290. Die Syntax ist: # Name | Index | Fakt | Summ | PotFakt | Kurzname #
  291. - Name: Name der Einheit (hier Ext. Einheit x)
  292. - Index: dient zur Auswahl der gültigen Ergebniseinheit; da ja unterschiedlichste
  293.          Einheiten eingetragen werden können, die aber untereinander nicht
  294.          konvertierbar sind (zB Längen - und Temperatureinheiten), wird jedem
  295.          Einheitentype ein bestimmter Index zugeordnet (zB allen Längeneinheiten
  296.          Index 1, alle Temperatureinheiten Index 2 usw)
  297.          Erlaubte Zahlen: 1-255
  298. - Fakt:  Umrechnungsfaktor bezüglich der Basiseinheit
  299.          zB neue Lägeneinheiten:
  300.          Fußlänge: 27 cm -> Faktor bezüglich Basis Meter: 0.27
  301.          Armspannweite: 175 cm -> Faktor bzgl. Basis Meter: 1.75
  302.          Erlaubte Zahlen: 1.7E-308 -1.7E+308
  303. - Summ:  Manche Datentypen (Grad Farenheit) lassen sich nicht durch eine Faktor
  304.          alleine darstellen, sondern benötigen zusätzlich einen Summanden.
  305.          zB Grad Farenheit = Grad Celsius * 1.8 + 32 => summ=32
  306.          Allgemein: 0
  307.          Erlaubte Zahlen:-3.4E-38 bis 3.4E38
  308. - PotFakt: bei gewissen Einheiten (vor allem Flächen- und Volumseinheiten) ist
  309.          ein Faktor für die richtige Potenzrechnung notwendig:
  310.          zB Kubikkilometer ist nicht gleich Kilokubikmeter
  311.          => für Volumseinheiten: PotFakt=3
  312.          => für Flächeneinheiten: PotFakt=2
  313.          Allgemein: 1
  314.          Erlaubte Zahlen: 2-255
  315. - Kurzname: ein maximal 9 Zeichen langer Kurzname für die Einheit, der dann
  316.          hinter dem Ergebnis aufscheint (zB m für Meter), Leerzeichen sind
  317.          erlaubt.
  318.  
  319. Die einzelnen Angaben sind durch "|" zu trennen
  320.  
  321.  
  322.  
  323. 8. Bekannte Fehler
  324.  
  325. Leider ist kein Programm der Welt absolut fehlerfrei; UnitConv ist hier keine Ausnahme.
  326.  
  327. Zur Zeit sind zwar keine Fehler bekannt, ich nehme aber an, daß einige Umrechnungsfaktoren
  328. fehlerhaft bzw. zu ungenau sind. Falls Sie auf einen solchen Fehler stoßen und/oder
  329. über einen genaueren Umrechnungsfaktor verfügen, so würde ich Sie bitten, mir diesen
  330. zukommen zu lassen, damit der Wert in zukünftigen Versionen korrigiert werden kann.
  331.  
  332.  
  333.  
  334. 9. Entwicklungsgeschichte, Zukünftige Entwicklungen
  335.  
  336. 9.1 Entwicklungsgeschichte
  337.  
  338. Version 1.00  (August 1994): 1. Prerelease
  339. Version 1.10d (April 1996) : kleinere Änderungen an der GUI (anderer Font, neuer
  340.                              About-Requester, kleinere Größe)
  341.                              1. Veröffentlichungsversion (AmiNet misc/math)
  342.  
  343. 9.2 Zukünfitige Entwicklungen
  344.  
  345. Folgende Erweiterungen und Verbesserungen sind für die kommenden Versionen geplant:
  346.  
  347. - volle Modularisierung (jede Gruppe-eigene Datei)
  348. - binäre Module 
  349. - Moduleditor
  350. - englische Version
  351. - MUI-Oberfläche
  352.  
  353.  
  354.  
  355. 10. Credits, sonstige SciTech-Programme
  356.  
  357. Verwendete Copyrights:
  358.  
  359. - DirectoryOpus: © Jonathan Potter, GPSoftware
  360. - ToolManager:   © Stefan Becker
  361. - MUI:           © Stefan Stunz, SASG
  362.  
  363. - Amiga, Workbench, CLI, Shell: © Amiga Technologies
  364.  
  365.  
  366. Sonstige SciTech-Programme:
  367.  
  368. - TextConv V1.00d (Test in AmigaSpezial 3/96 - Urteil "Sehr gut")
  369.   ASCII Text Konverter (Amiga/MS-DOS/Windows/Mac)
  370.   AmiNet: util/conv/textconv.lha
  371.   AmiNetCD: 10
  372.   Version 1.5 erscheint ca. Sommer 96 (schneller, Atari-Unterstützung, Fehler in Mac-
  373.   Konvertierung behoben, beliebig große Dateien)
  374.  
  375. - PicInfo V1.00
  376.   Erkennung und Auswertung von Grafikdateien hinsichtlich Auflösung, Farbtiefe und
  377.   Kompression. Erkennt zur Zeit ca.30 verschiedene Datentypen (IFF, PCX, TIFF, BMP,...)
  378.   Veröffentlichung ca. Herbst 96, Prerelease verfügbar
  379.  
  380. - PSRealName V1.00
  381.   Umbenennung von #?.pfb (Windows-TypeManager) Postscript-Fonts in ihre richtigen Namen
  382.   Veröffentlichung ca. Sommer 96, Prerelease verfügbar
  383.  
  384. - EqualFileType V1.00
  385.   Filtern von "MagicBytes" zur Dateityperkennung aus mehreren (bis zu 50) Dateien
  386.   Veröffentlichung ca. Sommer 96, Prerelease verfügbar
  387.  
  388.  
  389.  
  390. 11. Kontaktadresse
  391.  
  392. Fehlerberichte, Verbesserungsvorschläge, Spenden etc an:
  393.  
  394.   Haas Alexander
  395.   Mitterndorf 150
  396.   A-4801 Traunkirchen
  397.   AUSTRIA
  398.   e-mail: alexander.haas@jk.uni-linz.ac.at
  399.  
  400.  
  401. WICHTIG: Anfragen bezuglich Zusendung von Programmen o.ä. können nur beantwortet werden,
  402.          wenn eine formatierte Diskette und ein ausreichend frankierter Rückumschlag
  403.          (oder Rückporto in Form von Bargeld) mitgeschickt werden.
  404.          Disketten werden ansonsten ausnahmslos als Nachnahme verschickt (teuer)!
  405.  
  406.